=============================================
CSPECT LOADING INSTRUCTIONS for Next-a-Sketch
=============================================

This program has been written as part of my learning process of Next BASIC and
its various additions over regular Spectrum BASIC, not least the new graphics
modes. It is the second such program after Tile Cutter, though probably a lot
less useful, and the first to see action in the CSSCGC.

Included are the following files:
- NAS10.BAS is the Next BASIC program, the only file that actually has to be
  installed on the Next.
- NAS10.TXT is the program listing converted to PC-readable text with
  NextZXOS' .bas2txt command.
- CSSCGC23.SL2 is an example screen, drawn with this program to show what it's
  really capable of. As if you thought it would be any more than this...

================================================================================


Installation instructions
-------------------------

I do not own a real Next yet. Apparently, the delivery date is still on for late
summer, or early autumn 2023. CSpect is the most capable Next emulator but can
be a bit finnicky to set up, and requires the use of a virtual SD card image.

If you don't have that SD card image already (how did you expect to get Next
emulation working without it?), download a pre-made image with all the files
needed to make a Next work properly, from https://zxspectrumnext.online - use
the "CSPECT Next distribution 2Gb SD Card Image", which will unzip to a file
cspect-next-2gb.img. Rename it if you want (I renamed mine SD1.IMG - make sure
to change the filename every time it's required in the guide below.)

Also, Mac and Linux users, you're on your own for the installation and use of
anything mentioned below - I know a bit about the use of ./ and CHMOD to execute
files and they'll be .SH instead of .BAT, but when it comes to compiling from
source, that's several orders of magnitude above my pay grade. Deal with it.

1.  First, in NextBASIC or in the Command line, create a folder "NAS"
    (MKDIR "NAS").
2.  Copy the file "NAS10.BAS" into this folder on the SD Card image.
    This will involve the use of HDFmonkey - details are given below. 
3.  Select Next BASIC, CD "NAS" and LOAD "nas10.bas".

As with a real Next, copying the other files supplied is optional.


Installation and use of HDFmonkey
---------------------------------

1.  HDFmonkey, by Gasman (found here: https://github.com/gasman/hdfmonkey) has
    to be compiled from source, and I can't help with that. However, there are
    pre-compiled packages out there, such as this one for Windows on
    https://uto.speccy.org, for as long as the link lasts:
    https://uto.speccy.org/downloads/hdfmonkey_windows.zip
2.  Drop HDFmonkey.exe into your CSpect directory, and create a folder "SD2"
    (which will hold files to be transferred between the SD card image and your
    CSpect folder). HDFmonkey works on the command line, so it's easier to make
    a batch file that will do the job easily:
    hdfmonkey put cspect-next-2gb.img SD2\nas10.bas NAS\nas10.bas
    Save this as HDFMUP.BAT, and run it.
3.  ASIDE: Note that to get files off the SD card image, replace "put" with
    "get" and switch SD2 and NAS around (or whatever folder you're copying
    items from on the image). e.g.:
    hdfmonkey get cspect-next-2gb.img NAS\scrawl.sl2 SD2\scrawl.sl2
    Save that as HDFMDOWN.BAT and edit it as necessary.


- JRW 14/1 - 20/1 MMXXIII
